home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / docs / ppaint6d.lha / PersonalPaint6.4Ch06.doc < prev    next >
Text File  |  1996-03-16  |  5KB  |  143 lines
  1.                  "Personal Paint  -  6. The Text Menu"
  2.  
  3.  6. The Text Menu
  4.   6.1 Insert Clipboard
  5.   6.2 Next Color
  6.   6.3 Preceding Color
  7.   6.4 Modify to End of Line
  8.        6.4.1 Color
  9.        6.4.2 Style
  10.        6.4.3 Upper Case
  11.        6.4.4 Lower Case
  12.        6.4.5 Delete
  13.   6.5 Style
  14.   6.6 Alignment
  15.  
  16. 6.         The Text Menu
  17.  
  18.    Personal Paint incorporates a text editor to write text in the image
  19. area. The menu items described in this chapter become accessible during a
  20. text editing session, which is activated by selecting the Text tool and
  21. selecting a position on the screen. Section 3.1.3 describes the basic text
  22. editing and font selection functions.
  23.  
  24.  
  25. 6.1        Insert Clipboard
  26.  
  27.    The Amiga Clipboard is used by several word processors, text editors
  28. and Amiga system functions. This command inserts a text stored into the
  29. Amiga Clipboard into the image area as if it were typed. Personal Paint
  30. correctly interprets ANSI SGR control sequences which may have been
  31. embedded in the text to control style and color variations.
  32.  
  33.    Section 5.9 has more on the Amiga Clipboard. The following explanation
  34. on SGR sequences is more technical, and should be of interest to users
  35. wishing to edit a text with an external text editor.
  36.  
  37.    SGR sequences are control codes which begin with the ESC + '['
  38. characters (or by on single CSI code, decimal value 155) and end with a
  39. lower case 'm'. For example, SGR31 would indicate ESC+'['+'3'+'1'+'m' ('3'
  40. and '1' are printable ASCII characters, not control codes). Normal text
  41. (or other control codes) may immediately follow an SGR sequence. Some of
  42. the most used SGR sequences are:
  43.  
  44.    from SGR30 to SGR39: set text color
  45.    from SGR40 to SGR49: set background color
  46.    SGR0: restore plain style
  47.    SGR1: begin bold text
  48.    SGR22: end of bold text
  49.    SGR3: begin italics
  50.    SGR23: end of italics
  51.    SGR4: begin underlining
  52.    SGR24: end of underlining
  53.  
  54.  
  55. 6.2        Next Color
  56.  
  57.    This command selects the color in the palette which follows the current
  58. color as the new foreground color. The new color is used for all the text
  59. which is going to be typed, regardless of the position of the text and the
  60. other colors which surround it.
  61.  
  62.    Color changes to entire lines of text can be applied with the Recolor
  63. to End of Line function (section 6.4.1).
  64.  
  65.  
  66. 6.3        Preceding Color
  67.  
  68.    This function is similar to Next Color, only that it selects the
  69. previous color in the palette. Both commands are equivalent to the paint
  70. mode keyboard shortcuts (<[> and <]>, by default) which can be used to
  71. select the preceding or next color. However, the latter one-key shortcuts
  72. would insert a character, rather than execute a command, in a text editing
  73. session.
  74.  
  75.  
  76. 6.4        Modify to End of Line
  77.  
  78.    This group of commands applies changes to the text between the current
  79. cursor position and the end of the line.
  80.  
  81.  
  82. 6.4.1      Color
  83.  
  84.    This function applies the current foreground color to the text.
  85.  
  86.  
  87. 6.4.2      Style
  88.  
  89.    This function applies the current text style (like italic or bold) to
  90. the text. The style must be specified before this command is executed.
  91.  
  92.  
  93. 6.4.3      Upper Case
  94.  
  95.    This command converts all characters between the cursor and the end of
  96. the line in their upper case (capital letters) form.
  97.  
  98.  
  99. 6.4.4      Lower Case
  100.  
  101.    This command transforms the selected characters into lower case.
  102.  
  103.  
  104. 6.4.5      Delete
  105.  
  106.    The text from the current cursor position to the end of the line is
  107. deleted.
  108.  
  109.  
  110. 6.5        Style
  111.  
  112.    Several menu items can be used to select the desired character style
  113. (plain text, italic, bold, etc.) The new style is applied to all text
  114. which is written after the style selection. A checkmark is displayed to
  115. the left of the menu items associated to the current style. Style variants
  116. can be combined for effects like italic bold underlined.
  117.  
  118.    The style of text which has already been typed can be modified with the
  119. Restyle to End of Line function (section 6.4.2).
  120.  
  121.    When a new style is selected, Personal Paint first tries to find a font
  122. variant of the current typeface having the desired attributes. If no such
  123. font exists, it is algorithmically generated from the current font.
  124.  
  125.    Sections 3.1.4 and 5.13 explain how to apply other effects to text,
  126. like blurring and outlines.
  127.  
  128.  
  129. 6.6        Alignment
  130.  
  131.    The text can be aligned and realigned in different ways (left, center
  132. or right). This command always changes the alignment of the entire text
  133. which is displayed by the current editing session.
  134.  
  135.    Since Personal Paint does not use explicit text margins to delimit the
  136. text editing area, the texts are aligned or centered along the vertical
  137. line which passes through the position where text editing started. The
  138. entire text (and the associated alignment line) can also be repositioned
  139. by "grabbing" it with the right mouse button. The text can be rearranged
  140. with great freedom by combining a change in alignment with an appropriate
  141. new text position.
  142.  
  143.